home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / atcheckpoint.z / atcheckpoint
Encoding:
Text File  |  2002-10-03  |  2.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaattttcccchhhheeeecccckkkkppppooooiiiinnnntttt((((3333CCCC))))                                              aaaattttcccchhhheeeecccckkkkppppooooiiiinnnntttt((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      atcheckpoint, atrestart - add checkpoint and restart (CPR) event handlers
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      #include <stdlib.h>
  13.  
  14.      int atcheckpoint(void (*_f_u_n_c)(void));
  15.  
  16.      int atrestart(void (*_f_u_n_c)(void));
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      These functions are used to register event handlers for checkpoint and
  20.      restart, and activate CPR signal handling.  The _a_t_c_h_e_c_k_p_o_i_n_t() routine
  21.      adds the function _f_u_n_c() to the list of functions to be called without
  22.      arguments upon receipt of checkpoint; see _c_k_p_t__c_r_e_a_t_e(3).  Similarly, the
  23.      _a_t_r_e_s_t_a_r_t() routine registers the callback function _f_u_n_c() for a restart
  24.      event; see _c_k_p_t__r_e_s_t_a_r_t(3).  At checkpoint or restart time, registered
  25.      functions are called in the same order as their registration.
  26.  
  27.      These functions are recommended for use during initialization when
  28.      applications expect to be checkpointed but contain checkpoint-unsafe
  29.      objects; see _c_p_r(1) for a list of unsafe objects.  An application may
  30.      register multiple checkpoint and/or restart event handlers to be called
  31.      when checkpoint and/or restart occur, for example to disconnect socket
  32.      connections at checkpoint time and reconnect them at restart time.
  33.  
  34. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  35.      The _a_t_c_h_e_c_k_p_o_i_n_t() and _a_t_r_e_s_t_a_r_t() routines return 0 if the registration
  36.      succeeds, or -1 with _e_r_r_n_o set if registration fails.  The maximum number
  37.      of handlers allowed for each process (or thread) is 32.
  38.  
  39. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  40.      _c_p_r(1), _c_v_i_e_w(1), _c_k_p_t__c_r_e_a_t_e(3), _c_k_p_t__r_e_m_o_v_e(3), _c_k_p_t__r_e_s_t_a_r_t(3),
  41.      _c_k_p_t__s_t_a_t(3)
  42.      _I_R_I_X _C_h_e_c_k_p_o_i_n_t _a_n_d _R_e_s_t_a_r_t _O_p_e_r_a_t_i_o_n _G_u_i_d_e
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.